home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 7 / BBS in a Box - Macintosh - Volume VII (BBS in a Box) (January 1993).iso / Files / Util / Sd-Sm / Sf.cpt / SF Replacement / SF ReadMe < prev    next >
Encoding:
Text File  |  1992-09-15  |  6.7 KB  |  163 lines  |  [TEXT/ttxt]
  1.  
  2. W A R N I N G • D A N G E R • W A R N I N G • D A N G E R • W A R N I N G
  3.  
  4. This program is not a final product. It is an early beta version intended to solicit comments to enhance further development. Do NOT use it in production mode - test with it then throw it away. Note that since the program affects you most when files are being saved, it will be very easy to lose work should problems occur.
  5.  
  6. This program is known to contain bugs and many cosmetic flaws. See the list at the end of the document.
  7.  
  8. ---------------------------------
  9. 'SF Dropper' - A Standard File Utility
  10. ---------------------------------
  11.  
  12. SF Dropper is an enhancement to the Standard File dialog utility for the Macintosh. The enhancement bypasses the regular dialogs in favor of allowing use of the more intuitive Finder interface for opening and creating files.
  13.  
  14. SF Dropper requires System 7.
  15.  
  16. -----------
  17. Installation
  18. -----------
  19.  
  20. Place the 'sf init' file into the Extensions folder.
  21. Place the 'sf template' file into the Preferences folder.
  22. Place the 'sf prefs' file into the Preferences folder.
  23. Place the 'sf defaults' program anywhere.
  24. Restart.
  25.  
  26. -------
  27. Removal
  28. -------
  29.  
  30. Temporary:
  31. Hold the shift key. In most situations this will take you back to the regular dialog.
  32.  
  33. Temporary:
  34. Use the 'sf defaults' program to turn it off. The change will take effect immediately.
  35.  
  36. Permanent:
  37. Remove the 'sf init' from the Extensions folder.
  38. Remove the 'sf template' file from the Preferences folder.
  39. Remove the 'sf prefs' file from the Preferences folder.
  40. Restart.
  41.  
  42. -------------------------
  43. User Interface - the Basics
  44. -------------------------
  45.  
  46. SF Dropper takes effect whenever the Standard File dialog is invoked.
  47.  
  48. When Open… (SFGet) is selected…
  49.  
  50. A file is created onthe desktop. The file has the same name as the current application but has a dropper icon.
  51. The user is switched to Finder.
  52. The user navigates through Finder in the normal way. The user opens folders, or may use the Find command to select a file.
  53. The user selects the file by dropping it onto the dropper icon on the desktop.
  54. The user is returned to his original application with the file opened.
  55. The dropper icon file is deleted.
  56.  
  57. When 'Save As…' or Save is selected…
  58.  
  59. A file is created on the desktop. The file is named with the suggested name from the putfile and has the current application's icon.
  60. The user is switched to Finder.
  61. The user navigates through Finder in the normal way. The user opens folders, or may use the Find command to select a file.
  62. The user moves the file into the folder where he wishes the new file to be created.
  63. The user names the file with an appropriate name.
  64. The user double-clicks the file.
  65. The user is returned to his original application with the file created.
  66. The dropper file is deleted.
  67.  
  68. ------------------
  69. Additional Features
  70. ------------------
  71.  
  72. For Save dialogs, moving the dropper application to another volume and double clicking to select the file location would normally result in a file copy. The user may alternately select the file by dropping the containing folder onto the dropper icon, or may drop any file from the containing folder onto the dropper icon.
  73.  
  74. Many dialogs contain additional dialog items. If there are additional items in the dialog they may be accessed by holding the option key as the open/save command is selected.  The dialog box is presented, but without many of the standard parts. The user may select options from the additional items, then can continue on to Finder. A 'revert' button is provided in the dialog, which takes the user back to the original dialog box.
  75.  
  76. If the SF GetFile contains a list of file types, then only those types are droppable.
  77.  
  78. Holding down the shift key while selecting opn/save will use the standard file dialog. Holding down the shift key after double clicking the dropper will cancel the selection.
  79.  
  80. Any attempt to select an application that is waiting for an sfput or sfget just returns to Finder. Holding down the shift key while attempting to switch back to the application will return to the old style dialog.
  81.  
  82. Any number of Open/Saves can be active at once.
  83.  
  84. The 'sf defaults' application will turn the modifications on and off on the fly. It can also be used to exclude applications.
  85.  
  86. !!!!!!!!!!!!!!!!!!!!!!!!
  87. Known Bugs
  88. !!!!!!!!!!!!!!!!!!!!!!!!
  89.  
  90. Programs that make severe modifications to SF Dialog boxes tend to hang. In particular, multiple add dialogs such as in Compact Pro and Think C are a big problem.
  91.  
  92. Teachtext - complains that the document is too large on open.
  93.  
  94. Has a consistent but seemingly random crash after many uses. Probably heap or nil pointer related, but haven't been able to track it down so far.
  95.  
  96. When multiple applications are running, the user is not always switched back to Finder, sometimes to another application instead.
  97.  
  98. The dropper program is not always cleared from the desktop immediately. Finder seems to lose it while maintaining the icon. This is harmless but cosmetically flawed.
  99.  
  100. Sometimes the dropper file copy to desktop is very slow.
  101.  
  102. The 'revert' button doesn't work when using the optional dialog.
  103.  
  104. There are times when a lack of a message is very inelegant. For instance, with a new document, Fullwrite will bring up an sf autosave dialog after 5 minutes. With sf dropper you suddenly end up in Finder with a 'untitled' Fullwrite document on the screen.
  105.  
  106. ----------------------
  107. Suggested Improvements
  108. ----------------------
  109.  
  110. Color Showinit for the startup icon.
  111.  
  112. Option to open the user's last window on an application basis.
  113.  
  114. Allow additional file types by application.
  115.  
  116. Add more options to the defaults program.
  117.  
  118. Add a control panel type icon to the defaults program, and add the document icons for the prefs files.
  119.  
  120. Allow default positioning of dropper application on desktop.
  121.  
  122. Provide a utility to delete old dropper files that remain after a crash.
  123.  
  124. Add fancy icons. Hey, I'm a programmer not an artist.
  125.  
  126. Exclude specific application dialogs rather than entire applications.
  127.  
  128. Move the preferences files into their own folder.
  129.  
  130.  
  131. --------------
  132. Change History
  133. --------------
  134.  
  135. .2ß - no major changes
  136.             - added documentation for other E-mail addresses
  137.  
  138. .2ß - fixed the seemingly random crashing problem.
  139.             - excluded applications are now really excluded
  140.             - Microsoft Word 4 works.
  141.  
  142. .1ß - the original upload to AOL Mac Developer Forum. There was a lack of
  143.           comments, so a wider audience was necessary.
  144.  
  145. ---------------------------------
  146. Comments, Suggestions and Feedback
  147. ---------------------------------
  148.  
  149. I can be reached as:
  150.  
  151. Darrell Pfeifer        (604) 652-8585
  152. America Online        DarrellPf
  153. Compuserve                    72637,3241
  154. GEnie                                        DPfeifer
  155. Applelink                            Darrell.P
  156.  
  157. Please note that although I appreciate your feedback, I may not have time to respond to all your comments. Thanks for your help.
  158.  
  159.  
  160. darrell
  161. September, 1992
  162.  
  163.